home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / packet / p_tapr / tnc118 / tnc2118.txt < prev   
Text File  |  1992-04-30  |  19KB  |  583 lines
  1. TNC-2 1.1.8  20 MAR 92  $F8  (16 bit checksum=21f8)
  2.  
  3.  
  4.                    Tucson Amateur Packet Radio TNC-2
  5.                              Release 1.1.8
  6.                         Firmware revision notes
  7.  
  8. Note:  The information in this package supplements, and in some cases
  9. supercedes, the information provided in the TAPR 1.1.7 command booklet.
  10.  
  11. Overview:
  12.  
  13.    Release 1.1.8 provides new features and fixes a couple of small bugs. 
  14. The frequently demanded host mode is now present, along with code that
  15. proposes a standard for polling other TNCs in a LAN without knowing all
  16. of the other TNCs' callsigns.
  17.  
  18.  
  19.                              NEW FEATURES
  20.  
  21. Host mode
  22.  
  23.    Release 1.1.8 supports a layered, relatively easy-to-implement
  24. protocol set (QAFT, DLC, and BLP) that enables the robust connection of
  25. one or more computers or TNCs to a TNC-2's RS-232 port.  A separately
  26. provided .ZIP archive available from TAPR contains documentation, a
  27. similarly poorly written host mode terminal program for a DOS machine,
  28. and even more poorly written protocol drivers in Microsoft C source.
  29.  
  30.    Warning:  Host mode has not been thoroughly tested by either the
  31. author or TAPR.  Please report any bugs to either or both for a hopefully
  32. prompt resolution of the problem.
  33.  
  34.  
  35. QRA or help for My path's fallen, and it can't get up
  36.  
  37.    QRA ("Who are you") pinging is supported in release 1.1.8. A QRA ping
  38. polls all of the TNCs within range.  Each TNC hearing the QRA ping will
  39. transmit its identification packet within 1 to 16. This technique
  40. provides the names of all reachable TNCs and digipeaters to the new,
  41. roving, and emergency-use packeteer.  Also see "ANSWRQRA" command.
  42.  
  43.    Note that the QRA function will not work if there are any digipeaters
  44. in the UNPROTO path.  This somewhat, but not completely, helps limit a
  45. malevolent user's ability to seriously harm the network.
  46.  
  47.    Sending QRA ping:
  48.  
  49.    1) Set the unprotocol callsign to QRA
  50.         cmd: UNPROTO  QRA<cr>
  51.  
  52.    2) Manually send an unconnected packet
  53.         cmd: CONVERSE<cr>
  54.         <cr>
  55.         ^C
  56.         cmd:
  57.  
  58.    3) In 1-16 seconds, if MONITOR is ON you should be receiving packets
  59. empty identification packets from other connectable and compatible TNCs.
  60.  
  61.         WB9FLW>ID:
  62.         AD7I>ID:
  63.         W5DID>ID:
  64.  
  65.  
  66.                              NEW COMMANDS
  67.  
  68.  
  69.  
  70.  
  71. ANSWRQRA  ON|OFF                                            Default: ON
  72.  
  73. Setting ANSWRQRA to OFF disables the TNC's ping-response function.  When
  74. the parameter is set ON, the TNC responds to non-digipeated UI frames
  75. addressed to QRA, within 1 to 16 seconds, with an empty ID packet.  TNC-2
  76. ignores QRA packets when ANSWRQRA is off.
  77.  
  78.  
  79. KISSM   {immediate command}
  80.  
  81. This command may be used to cause the TNC to immediately begin running
  82. the KISS code.  Note this is a different protocol than used by TNC-2
  83. QAFT/DLC/BLP.
  84.  
  85.  
  86. OUT nn  0<=nn<=255
  87.  
  88. The value 'nn' is sent to the TNC's z/80 i/o port 0BFH.  Note that the
  89. last value 'nn' is sent to the i/o port frequently, but not immediately. 
  90. In this context, 'frequently' means many times per second, and 'not
  91. immediately' means within at most 100ms.
  92.  
  93.  
  94. TXDIDDLE ON|OFF                                             Default: ON
  95.  
  96. The TNC sends NRZI 0s during TXDELAY/TXDELAYC intervals if TXDIDDLE is
  97. ON, and 7EH flags when it is OFF.  TXDIDDLE should be kept ON unless you
  98. are certain the TNCs in your network require lengthy flagging intervals.
  99.  
  100. A few 1.1.7 users (TXDIDDLE was forced to ON in 1.1.7) reported problems
  101. with other TNCs that require flags during TXDELAY/TXDELAYC for carrier
  102. detection.  Now when this problem crops up, the 1.1.8 user has the
  103. ability to turn TXDIDDLE OFF and restore connectivity.
  104.  
  105.  
  106.  
  107.                                  FIXES
  108.  
  109.  
  110. o -Fixed the erroneous bbRAM failure indication that sometimes happened
  111.    when the  already-connected remote TNC reconnected through a different
  112.    path.
  113.  
  114. o -Repaired the transparent mode "TXFLOW ineffectiveness during XFLOW ON"
  115.    bug.
  116.  
  117. o -KISS has access to 75BAH bytes of free RAM
  118.  
  119.  
  120. Please send suggestions, comments, criticisms to Tucson Amateur Packet
  121. Radio, Inc., or direct to the TNC-2 evolution control substation
  122. maintained by
  123.  
  124.                       Howard Goldstein N2WX@W4DPH
  125.                            CIS:   75006,702
  126.                           GENIE: H.GOLDSTEIN5
  127.                        FAX only: 1-813-321-5396
  128.  
  129.  
  130.                 TNC-2 - The revolution hangs in there!
  131.  
  132.  
  133.                   Tucson Amateur Packet Radio
  134.                        P. O. Box 12925
  135.                    Tucson, AZ 85732-2925
  136.  
  137.  
  138.      ---------------------------------------------------------------------
  139.  
  140.  
  141. Default Locations
  142.  
  143. The default parameters for the various TNC 2 commands are located in the
  144. 1.1.8 EPROM.  The defaults are documented here for those of you who wish
  145. to change them for particular applications (such as remotely located
  146. units, etc.).  For release 1.1.8, the defaults table is found at address
  147. 0B98 hex.
  148.  
  149. NOTE:  In future releases of firmware, this location may change.  There
  150. is a pointer at address 0055H which contains the location of the default
  151. area in Z80 low-byte/high-byte format.
  152.  
  153. WARNING!  The TNC 2 firmware does not check for valid defaults.  If you
  154. program an invalid default (for example, parity 5), unpredictable results
  155. may occur.  Be sure you double-check any defaults you change!
  156.  
  157. The defaults are listed in the table below.  All notes follow the table.
  158.  
  159. EPROM             Value     Meaning   Command   Notes
  160. Address      (Hex)
  161. (Hex)
  162. 0B98         21   33        DWAIT     33*10 mSec
  163. 0B99         00   0         AXHANG    0*100 mSec
  164. 0B9A         00   0         PACTIME   EVERY/AFTER* 
  165. 0B9B         0A   10        PACTIME   10*100 mSec
  166. 0B9C         21   33        DEADTIME  33*10 mSec
  167. 0B9D         0E   14        ACKTIME   14*10 mSec
  168. 0B9E         02   2         DLCTICKTIME    (do not change this)
  169. 0B9F         01   1         CMDTIME   1*1 Sec
  170. 0BA0         21   33        TXDELAY   33*10 mSec
  171. 0BA1         05   5         reserved - must be 5
  172. 0BA2         1E   30        TXTMOTMR  30*1 Sec  Note 1
  173. 0BA3         01   1         TODVAL    1*1 Sec   Note 2
  174. 0BA4         39   57        IDVAL     57*10 Sec Note 3
  175. 0BA5         00   0         RESPTIME  0*100 mSecStream A
  176. 0BA6         00   0         RESPTIME  0*100 mSecStream B
  177. 0BA7         00   0         RESPTIME  0*100 mSecStream C
  178. 0BA8         00   0         RESPTIME  0*100 mSecStream D
  179. 0BA9         00   0         RESPTIME  0*100 mSecStream E
  180. 0BAA         00   0         RESPTIME  0*100 mSecStream F
  181. 0BAB         00   0         RESPTIME  0*100 mSecStream G
  182. 0BAC         00   0         RESPTIME  0*100 mSecStream H
  183. 0BAD         00   0         RESPTIME  0*100 mSecStream I
  184. 0BAE         00   0         RESPTIME  0*100 mSecStream J
  185. 0BAF         0C   12        CHECK     12*10 Sec Stream A
  186. 0BB0         0C   12        CHECK     12*10 Sec Stream B
  187. 0BB1         0C   12        CHECK     12*10 Sec Stream C
  188. 0BB2         0C   12        CHECK     12*10 Sec Stream D
  189. 0BB3         0C   12        CHECK     12*10 Sec Stream E
  190. 0BB4         0C   12        CHECK     12*10 Sec Stream F
  191. 0BB5         0C   12        CHECK     12*10 Sec Stream G
  192. 0BB6         0C   12        CHECK     12*10 Sec Stream H
  193. 0BB7         0C   12        CHECK     12*10 Sec Stream I
  194. 0BB8         0C   12        CHECK     12*10 Sec Stream J
  195. 0BB9         05   5         reserved - must be 5
  196. 0BBA         00   0         reserved - must be 0
  197. 0BBB         00   0         reserved - must be 0
  198. 0BBC         00   0         reserved - must be 0
  199. 0BBD         00   0         reserved - must be 0
  200. 0BBE         00   0         reserved - must be 0
  201. 0BBF         00   0         reserved - must be 0
  202. 0BC0         00   0         reserved - must be 0
  203. 0BC1         00   0         reserved - must be 0
  204. 0BC2         00   0         reserved - must be 0
  205. 0BC3         00   0         reserved - must be 0
  206. 0BC4         01   1         BEACON EVERY/AFTER*,DEF EVERY
  207. 0BC5         00   0         BEACON TIME (0 = never)
  208. 0BC6         9C   'N'       MYCALL              Note 4
  209. 0BC7         9E   'O'
  210. 0BC8         86   'C'
  211. 0BC9         82   'A'
  212. 0BCA         98   'L'
  213. 0BCB         98   'L'
  214. 0BCC         60   SSID 0
  215. 0BCD         00   0         must be 0 - end of callsign string
  216. 0BCE         40   ' '       MYALIAS             Note 4
  217. 0BCF         40   ' '
  218. 0BD0         40   ' '
  219. 0BD1         40   ' '
  220. 0BD2         40   ' '
  221. 0BD3         40   ' '
  222. 0BD4         60   SSID 0
  223. 0BD5         00   0         must be 0 - end of callsign string
  224. 0BD6         08   8         FRACK     8*1 Sec
  225. 0BD7         80   128       PACLEN
  226. 0BD8         0A   10        RETRY
  227. 0BD9         00   0         reserved - must be 0
  228. 0BDA         04   4         MAXFRAME
  229. 0BDB         07   7         AWLEN - must be 7 or 8
  230. 0BDC         03   3         PARITY    EVEN      Note 5
  231. 0BDD         00   0         AXDELAY
  232. 0BDE         02   2         TXDELAYC
  233. 0BDF         03   3         SLOTS
  234. 0BE0         7C   '|'       STREAMSW Character
  235. 0BE1         01   1         USERS
  236. 0BE2         0D   ^M        SENDPAC Character
  237. 0BE3         18   ^X        CANLINE Character
  238. 0BE4         19   ^Y        CANPAC Character
  239. 0BE5         03   ^C        COMMAND Character
  240. 0BE6         08   ^H        DELETE Character
  241. 0BE7         16   ^V        PASS Character
  242. 0BE8         12   ^R        REDISPLAY Character
  243. 0BE9         13   ^S        STOP Character
  244. 0BEA         11   ^Q        START Character
  245. 0BEB         13   ^S        XOFF Character
  246. 0BEC         11   ^Q        XON Character
  247. 0BED         00   0         NULLS
  248. 0BEE         00   0         SCREENLN
  249. 0BEF         0000 0         CLKADJ
  250. 0BF1         00   0         TAPRLATCH      
  251. 0BF2         00   0         MFILTER 1st Parameter
  252. 0BF3         00   0         MFILTER 2nd Parameter
  253. 0BF4         00   0         MFILTER 3rd Parameter
  254. 0BF5         00   0         MFILTER 4th Parameter
  255. 0BF6         00   0         MFILTER 5th Parameter
  256. 0BF7         09   CMDS3                         Note 7
  257. 0BF8         6A   CMDS4                         Note 8
  258. 0BF9         44   CMDS5                         Note 9
  259. 0BFA         00   CMDS6                         Note 10
  260. 0BFB         20   CMDS7                         Note 11
  261. 0BFC         3D   CMDS8                         Note 12
  262. 0BFD         02   CMDS9                         Note 13
  263. 0BFE         46   CMDS10                        Note 14
  264. 0BFF         1F   CMDS11                        Note 15
  265. 0C00         60   CMDS12                        Note 16
  266. 0C01         B8   CMDS13                        Note 17
  267. 0C02         60   CMDS14                        Note 18
  268. 0C03         00   0         MYDLCNUM
  269. 0C04         FE   254       DEFLTDLC
  270. 0C05         00   0         Last Beacon Time - default to 0
  271. 0C06         8D             reserved - must be 08DH
  272. 0C07         00   0         reserved - must be 0
  273. 0C08         00   0         reserved - must be 0
  274. 0C09         00   0         reserved - must be 0
  275. 0C0A         00   0         reserved - must be 0
  276. 0C0B         00   0         reserved - must be 0
  277. 0C0C         00   0         reserved - must be 0
  278. 0C0D         00   0         reserved - must be 0
  279. 0C0E         00   0         reserved - must be 0
  280. 0C0F         00   0         reserved - must be 0
  281. 0C10         00   0         reserved - must be 0
  282. 0C11         00   0         reserved - must be 0
  283. 0C12         00   0         reserved - must be 0
  284. 0C13         00   0         reserved - must be 0
  285. 0C14         00   0         reserved - must be 0
  286. 0C15         00   0         reserved - must be 0
  287. 0C16         00   0         reserved - must be 0
  288. 0C17         00   0         reserved - must be 0
  289. 0C18         86   'C'       UNPROTO CALL        See Note 4
  290. 0C19         A2   'Q'
  291. 0C1A         40   ' '
  292. 0C1B         40   ' '
  293. 0C1C         40   ' '
  294. 0C1D         40   ' '
  295. 0C1E         60   SSID 0
  296. 0C1F         00   0         must be 0 - end of callsign string
  297. 0C25              MFLAGS                        Note 19
  298. 0C26              DFLAGS                        Note 20
  299. 0C27              CONFLAG                       Note 21
  300. 0C28              ENTRYSTA                      Note 22
  301. 0C29              ENT2                          Note 23
  302.  
  303. NOTES
  304.  
  305. Note 1
  306.    This is the timer which, when it is exceeded, increments the TXTIMEOUT
  307.    Health counter.
  308.  
  309. Note 2
  310.    TODVAL specifies the number of "ticks" the DAYTIME clock increments
  311.    each second.  It should always be set to 1.
  312.  
  313. Note 3
  314.    IDVAL is not otherwise settable.  It specifies the number of 10-second
  315.    intervals which elapse between IDs when HID is ON.
  316.  
  317. Note 4
  318.    Callsigns are encoded per the AX.25 standard document.  A callsign
  319.    consists of six (6) numbers and letters.  The letters must be upper
  320.    case and, if the callsign is less than six (6) elements long, must be
  321.    right-filled with blanks.  The ASCII values corresponding to the
  322.    letters and numbers must be left-shifted one bit.
  323.  
  324.    The letters and numbers in HEX are:
  325.  
  326.   Char      ASCII      Call
  327.    (BLANK)   20        40
  328.    A         41        82
  329.    B         42        84
  330.    C         43        86
  331.    D         44        88
  332.    E         45        8A
  333.    F         46        8C
  334.    G         47        8E
  335.    H         48        90
  336.    I         49        92
  337.    J         4A        94
  338.    K         4B        96
  339.    L         4C        98
  340.    M         4D        9A
  341.    N         4E        9C
  342.    O         4F        9E
  343.    P         50        A0
  344.    Q         51        A2
  345.    R         52        A4   
  346.    S         53        A6
  347.    T         54        A8
  348.    U         55        AA
  349.    V         56        AC
  350.    W         57        AE
  351.    X         58        B0
  352.    Y         59        B2
  353.    Z         5A        B4
  354.    0         30        60
  355.    1         31        62
  356.    2         32        64
  357.    3         33        66
  358.    4         34        68
  359.    5         35        6A
  360.    6         36        6C
  361.    7         37        6E
  362.    8         38        70
  363.    9         39        72
  364.  
  365. A seventh callsign value is the secondary station ID (SSID).  This is a
  366. value from 0 through 15 and is encoded as:
  367.  
  368. Bit  7    6    5    4    3    2    1    0
  369.      0    1    1    D    C    B    A    0
  370.  
  371. where D is the most significant bit and A the least in the binary value
  372. (0 through 15).
  373.  
  374. Note 5
  375.  
  376. Parity for the asynchronous serial port is:
  377.  
  378.      Value     Meaning 
  379.        0       None
  380.        1       Odd
  381.        2       None
  382.        3       Even
  383.  
  384. Note 6
  385.  
  386. Binary status and parameter elements (commands whose arguments are
  387. ON/OFF) are encoded as 
  388.  
  389.      ON  = TRUE  = 1
  390.      OFF = FALSE = 0
  391.  
  392. Commands which are "negative-true logic" (FALSE = 1 and TRUE = 0) are
  393. indicated by trailing asterisks (*).
  394. There are several defaults that are encoded on a bit basis.  These are
  395. listed below.
  396.  
  397. Note 7    CMDS3
  398.      Bit  Command   Default
  399.      7-   CMSG on/off
  400.      6-   CONMODE   trans/conv*
  401.      5-   NULF      on/off
  402.      4-   NUCR on/off
  403.      3-   LCOK      on/off
  404.      2-   PASSALL   on/off
  405.      1-   TXFLOW    on/off
  406.      0-   AX25L2V2  on/off
  407.  
  408. Note 8    CMDS4
  409.      Bit  Command   Default
  410.      7-   ESCAPE    on/off
  411.      6-   XMITOK    on/off
  412.      5-   DIGIPEAT  on/off
  413.      4-   LFADD     on/off
  414.      3-   BKONDEL   on/off
  415.      2-   DELETE    on/off
  416.      1-   ECHO on/off
  417.      0-   BUDLIST   on/off
  418.  
  419. Note 9    CMDS5
  420.      Bit  Command   Default
  421.      7-   CONSTAMP  on/off
  422.      6-   DAYUSA    on/off
  423.      5-   NEWMODE   on/off
  424.      4-   reserved
  425.      3-   MCOM on/off
  426.      2-   MALL on/off
  427.      1-   HID       on/off
  428.      0-   HEADRLN   on/off
  429.  
  430. Note 10   CMDS6
  431.      Bit  Command   Default
  432.      7-   STREAMCA  on/off
  433.      6-   STREAMDB  on/off
  434.      5-   reserved
  435.      4-   reserved
  436.      3-   reserved
  437.      2-   8BITCONV  on/off
  438.      1-   TRFLOW    on/off
  439.      0-   MSTAMP    on/off
  440.  
  441. Note 11   CMDS7
  442.      Bit  Command   Default
  443.      7-   reserved
  444.      6-   reserved
  445.      5-   LCSTREAM  on/off
  446.      4-   reserved
  447.      3-   NOMODE    on/off
  448.      2-   RXBLOCK   on/off
  449.      1-   HEALLED   on/off
  450.      0-   CBELL     on/off
  451.  
  452. Note 12   CMDS8
  453.      Bit  Command   Default
  454.      7-   LFIGNORE  on/off
  455.      6-   CMSGDISC  on/off
  456.      5-   reserved
  457.      4-   reserved
  458.      3-   reserved
  459.      2-   reserved
  460.      1-   reserved
  461.      0-   reserved
  462.  
  463. Note 13   CMDS9
  464.      Bit  Command   Default
  465.      7-   reserved
  466.      6-   BBSMSGS   on/off
  467.      5-   reserved
  468.      4-   reserved
  469.      3-   reserved
  470.      2-   reserved
  471.      1-   reserved
  472.      0-   reserved
  473.  
  474. Note 14   CMDS10
  475.      Bit  Command   Default
  476.      7-   reserved
  477.      6-   reserved
  478.      5-   reserved
  479.      4-   reserved
  480.      3-   reserved
  481.      2-   reserved
  482.      1-   reserved
  483.      0-   reserved
  484.  
  485. Note 15   CMDS11
  486.      Bit  Command   Default
  487.      7-   reserved
  488.      6-   MNONAX25  on/off
  489.      5-   reserved
  490.      4-   reserved
  491.      3-   reserved
  492.      2-   reserved
  493.      1-   TXUIFRAM  on/off
  494.      0-   FIRMRNR   on/off
  495.  
  496. Note 16   CMDS12
  497.      Bit  Command   Default
  498.      7-   reserved
  499.      6-   ACKPRIOR  on/off
  500.      5-   TXDIDDLE  on/off
  501.      4-   KISS      on/off
  502.      3-   CHECKV1   on/off
  503.      2-   reserved
  504.      1-   reserved
  505.      0-   reserved
  506.  
  507. Note 17   CMDS13
  508.      Bit  Command   Default
  509.      7-   reserved
  510.      6-   reserved
  511.      5-   reserved
  512.      4-   reserved
  513.      3-   reserved
  514.      2-   BLP       on/off
  515.      1-   reserved
  516.      0-   reserved
  517.  
  518. Note 18   CMDS14
  519.      Bit  Command   Default
  520.      7-   reserved
  521.      6-   ANSWRQRA  on/off
  522.      5-   reserved
  523.      4-   reserved
  524.      3-   reserved
  525.      2-   reserved
  526.      1-   reserved
  527.      0-   reserved
  528.  
  529. Note 19   MFLAGS
  530.      Bit  Command   Default
  531.      7-   reserved
  532.      6-   reserved
  533.      5-   reserved
  534.      4-   reserved
  535.      3-   TRACE     Off
  536.      2-   MCON On
  537.      1-   MRPT On
  538.      0-   MONITOR   On
  539.  
  540. Note 20   DFLAGS
  541.      Bit  Command   Default
  542.      7-   reserved
  543.      6-   reserved
  544.      5-   reserved
  545.      4-   reserved
  546.      3-   reserved
  547.      2-   reserved
  548.      1-   reserved
  549.      0-   reserved
  550.  
  551. Note 21   CONFLAG
  552.      Bit  Command   Default
  553.      7-   reserved
  554.      6-   reserved
  555.      5-   reserved
  556.      4-   FLOW On
  557.      3-   CR        On
  558.      2-   reserved
  559.      1-   FULLDUP   Off
  560.      0-   CONOK     On
  561.  
  562. Note 22   ENTRYSTA
  563.      Bit  Command   Default
  564.      7-   reserved
  565.      6-   reserved
  566.      5-   reserved
  567.      4-   reserved
  568.      3-   reserved
  569.      2-   reserved
  570.      1-   AUTOLF    On
  571.      0-   reserved
  572.  
  573. Note 23   ENT2
  574.      Bit  Command   Default
  575.      7-   reserved
  576.      6-   reserved
  577.      5-   reserved
  578.      4-   reserved
  579.      3-   reserved
  580.      2-   XFLOW     On
  581.      1-   reserved
  582.      0-   reserved
  583.